BIKLOG3 V 1.2 ******************************************************** * For the Psion Series 3a and Series 3c. * ******************************************************** (Copyright, ¸ Jaap Lam‚ris. November 1999) INTRODUCTION ============ BIKLOG3 is a program made for bicyclists who like to keep track of their bicycle rides during time. It is not meant to be used during the ride as a cycle computer but as an extension of it to store the cycle computer data and as a tool to analyse the bicycle rides over time. This program was my first major attempt at programming in OPL. It was completely developed on my Series 3a with the aid of the S3a emulator. I have tried to make the program to be user friendly as far as possible, and have released it after a long period of using it myself (during more than a year). This program is freeware, not because I don't need the additional income or fancy the merits of this program, - I spent a large amount of time and effort in creating and debugging this program -, but charging for something I wrote as a hobby and for fun is not my style. Further by making it freeware (or better said postcardware, see the section REGISTERING) I will not be forced to spent considerable time in maintaining and supporting it just for the sake of getting a small additional income. That doesn't mean that I will not support it anymore. As an user of BIKLOG3 myself and as a perfectionist by nature I will keep improving the program and supporting any users of it. Another reason to release it as freeware are some bad experiences in the past with shareware (PSION and PC) programs for which I paid the registration, after which the author did not support it any more, released it as freeware or kept charging for updates despite his earlier promises... . REQUIREMENTS ============ Below is a file list with file sizes in bytes. BIKLOG3.OPA - 21.0 kb the application file BIKE.INI - 217 the default configuration file BIKLOG3.RSC - 3.2 kb the help file optional: bik97.ODB - 8.2 kb example database bik97.INI - 217 configuration file for example BIKLOG3.TXT - 9.7 kb this file A minimal installation only requires "BIKLOG3.OPA" and "bike.ini". A minimal installation means that no online help is available. INSTALLATION ============ Below is a list if files supplied in the distribution ZIP file (The file biklog12.ZIP) and the directories they should be placed in. M:\APP\biklog3.OPA Main application file. M:\APP\biklog\biklog3.RSC BIKLOG help file. M:\APP\biklog\bike.ini configuration file Optionally: M:\APP\biklog\bik97.odb example database M:\APP\biklog\bik97.ini example configuration file Alternatively you may install BIKLOG3 on any other drive (drive A or B if you have an SSD. BIKLOG3.OPA does not have to be on the same drive as it's support files (BIKE.ini and BIKLOG3.RSC) as long as you preserve the correct directory structure, see above. It is recommended not to place the *.odb and *.ini files on a SSD drive, since they will be regularly be updated. For a minimal installation all you really need is the file "BIKLOG3.OPA", but it is much more user friendly with it's support files. If you are short of memory space, just use the main OPA file, and skip the next section of this text. To install, unzip the file BIKLOG12.ZIP, the directory stucture is retained in the file, so all the files are placed correctly if you unzip it from your PC to the Psion, or directly on your Psion. If you are moving the files manually from your PC, see the list of directories, above. INSTALLING BIKLOG3 ON THE SYSTEM SCREEN To install BIKLOG3 on the system screen, press PSION-I and select "BIKLOG3.OPA". USAGE ===== Most of the information you may need on how to use BIKLOG3 is included on the on-line help. If you do not install the online help here is a description of all hot-key presses (All keys require the Psion key to be held down, if the Shift key is also required the letter will be upper case, otherwise they will be lower case.) o Open a file - Always required, except when creating a new file. Enter filename or use TAB or cursor to cycle through existing files n Create a new file - After entering the name of the new file, you will be asked for entering the names of up to four bicycles in your household, and the type of bicycle rides you want to tag to your rides (like commute, training, race, clubride). Maximal five ride definitions are possible. c Close the current file - Only needed if you want to switch to another database file. D Delete a file S Sort current file - This will sort the records according to ascending date. The plotting option assumes that the records are sorted by date! If not you will get strange effects. a Add a record - Here you enter the date, bicycle name, bicycle ride type, distance, time or average speed and a short descriptions (max. xx characters) of the ride. By default the current date and the values of the last entered record will be entered. You may choose to enter average speed or time. Either one is sufficient. s scan records - All the records will be listed line by line. Use the cursor up, down, and the PgUp or PgDn keys to move or scroll up or down, respectively. HOME or END will move to the first or last record. ESC will exit the scan mode, while HELP will invoke a listing of possible actions. The left or right cursor keys will cycle through a long or shortened version of the record text. (with or without the memo). A Alter a record e Erase a record f Find a string in the records -Use this option to find a string in the memo field of one or more records p Plot the (cum.) distances per bicycle or ride type -You will be prompted to enter starting and ending date of the time period, and the time unit along the x-axis (day, week or months). By default the starting date will be January 1th of the year of the first record, and the ending date will be the current date. Cumulative distance plots will be presented for each of the available bicycles (with more than 0 km) in the database plus all bicycles together. Use the up and down cursor keys to cycle through the plots, ESC will return to the menu, while HELP will lists the available actions. P Preferences settings -use this option to customise the bicycle names, and ride definitions. ? Info on program h Help function I Statistical description of rides -Four tables will show you some common statistics (# of rides, cumulative and mean distances and duration for each bicycle and ride type in the database, absolute and relative to the total bike rides. x Exit I do recommend that you use the online help, at least until you become familiar BIKLOG3. ACKNOWLEDGEMENTS ================ Thanks to Jezar for providing the Help generator, Neil K Bee (neil@bee.net) for the use of one of his icons, and all other PSION programmers, especially Steve Litchfield and Al Richey with their RMREVENT program, who gave me examples of goord working programs. REGISTRATION ============ WHY REGISTER ? Although BIKLOG3 is freeware, I would be very happy if you let me know that you are going to use my programme. First of all to satisfy my curiosity, after putting numerous hours and effort in writing and debugging this program. Secondly it will encourage me to continue further with this program and extend it if you indicate a need for this. Thirdly I will be able to keep you informed on next releases of BIKLOG3, if you registrate it by me. HOW DO I REGISTER ? Preferably you can send your name, adress and/or Email adres by Email to: Jaap Lameris lamerisj@hotmail.com Else you can send a postcard to: Jaap Lameris Richel 10 8303 KX EMMELOORD Netherlands. Please include in your registration note, the version number, you got, your postal adress and Email adress. Additional information on BIKLOG3 will be also available on my homepage: http://Jaap_Lameris.tripod.com/mypsion.htm DISCLAIMER ========== Use this software at your own risk. I will not be held responsible for any loss of data and/or any damage caused to users or hardware caused by this software. COPYRIGHT AND CONDITIONS ======================== I reserve copyright on this material, any reproduction in part or whole is strictly prohibited. Additionally, reverse translation of any of files included in the file "BIKLOG12.ZIP" is strictly prohibited. You are permitted to distribute the file "biklog12.ZIP", as widely as you see fit, under one condition. That condition being; That the file is not in any way altered, and is sent on in an unchanged state. FEEDBACK ======== If you have any comments or suggestions for me I would be pleased to hear from you ! You can mail me at the above address or you can email me at these email addresses; lamerisj@hotmail.com or lameris-molhoek@hetnet.nl Now get on and start bicycling !!! HISTORY ======= Version 1.2 (Nov. '99): Minor bugs solved. After each operation the main display returns. Now named Biklog3 due to new version for the Series called Biklog5. Version 1.1 (Feb. '99): Better events scheduling applied based on RMREVENT code. Extended help text. Version 1.0 (Jan. '99): Original release.